home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).adf / ak_gen0-lib_V38.20.LHA / ak_gen0-library / AK_GEN0-Lib_DEU.doc next >
Text File  |  1993-10-17  |  8KB  |  286 lines
  1.  
  2.               ak_gen0.library V38.20
  3.  
  4.                - FREEWARE -
  5.  
  6.          © 1989-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           Dieses Programm wurde unter OS V3.00 geschrieben und ist
  9.           deshalb voll kompatibel. Es benötigt OS >= V1.2.
  10.  
  11.           Nachfolge-Library der "ak.library".
  12.  
  13.           Release Datum : 17.10.1993
  14.  
  15.  
  16.     Copyright :
  17.     ===========
  18.  
  19.     Das Programm ak_gen0.library V38.20
  20.     und seine Dokumentations-Dateien sind
  21.     (C)opyright 1989-93 by Andreas R. Kleinert. Alle Rechte vorbehalten.
  22.  
  23.     Die Verwendung der "ak_gen0.library" für eigene Programme ist dann
  24.     gestattet, wenn es sich um nicht kommerzielle Programme, also PUBLIC
  25.     DOMAIN oder FREEWARE handelt.
  26.  
  27.     Programmierer von SHAREWARE-Programmen, die mehr als 20,- DM verlangen,
  28.     oder Programmierer von kommerziellen Programmen benötigen meine schrift-
  29.     liche Erlaubnis für die Verwendung der "ak_gen0.library".
  30.  
  31.  
  32.     Einschränkungen :
  33.     =================
  34.  
  35.     Der Autor übernimmt keine Verantwortung für irgendeine Art von Auswir-
  36.     kungen, die durch die Nutzung dieses Programmes entstehen.
  37.     Diese Software wird zur Verfügung gestellt "WIE SIE IST" und es wird
  38.     keine Garantie irgendeiner Art übernommen, so daß Sie diese Software
  39.     auf eigenes Risiko nutzen.
  40.  
  41.  
  42.     Distribution :
  43.     ==============
  44.  
  45.     Das Programm ak_gen0.library V38.20 ist frei vertreibbar (FREEWARE).
  46.     Sie können es kopieren, solange der Copyright-Vermerk erhalten bleibt
  47.     und alle Bestandteile auch Teil der Distribution bleiben.
  48.     Dieses Programm darf ohne meine schriftliche Erlaubnis nicht nicht in
  49.     kommerzielle Programm-Pakete oder "-Kollektionen" miteinbezogen werden.
  50.     Dieses Programm darf nicht in irgendeiner Form verkauft werden, aber es
  51.     ist erlaubt, eine kostendeckende Kopiergebühr zu verlangen.
  52.  
  53.     Dieses Programm darf auf Public Domain-Serien veröffentlicht oder
  54.     in Public Domain Bibliotheken übernommen werden.
  55.     Besondere Erlaubnis hierfür geht hiermit an Fred Fishs AmigaLib-Disks
  56.     und die deutschen Serien TAIFUN, FRANZ, TIME, GPD und Amiga Szene.
  57.  
  58.     Dieses Programm darf außerdem per "electronic mail" verbreitet und
  59.     in Mailboxen angeboten werden, solange die Distributions-Bedingungen
  60.     in allen Punkten respektiert werden.
  61.  
  62.     Durch die Verwendung oder Weitergabe dieses Programmes akzeptieren Sie
  63.     automatisch alle der obigen Bedingungen und Vereinbarungen.
  64.  
  65.  
  66.     Funktion :
  67.     ==========
  68.  
  69.     Die "ak_gen0.library" findet Verwendung in vielen von mir geschriebenen
  70.     Programmen und enthält viele Funktionen, die die Programmierung z.B. von
  71.     Intuition sehr erleichtern.
  72.  
  73.  
  74.     Installation :
  75.     ==============
  76.  
  77.     Kopieren Sie die "ak_gen0.library" einfach in das "LIBS:"-Verzeichnis
  78.     Ihrer Diskette.
  79.  
  80.  
  81.     Benutzung :
  82.     ===========
  83.  
  84.     Die "ak_gen0.library" verwendet STACK-Parameter und kann deshalb nicht
  85.     von AmigaBASIC aus genutzt werden. Sie wurde für SAS/C und kompatible
  86.     Programmiersprachen entwickelt.
  87.  
  88.     Die "ak_gen0.library" beinhaltet ...
  89.  
  90.      - Funktionen zum komfortablen Öffnen von Windows und Screens
  91.      - Funktionen zum einfachen Erstellen von Gadgets, Menüs, Submenüs, u.a.
  92.      - Funktionen zur einfachen Ausgabe von Texten
  93.      - einen leicht zu bedienenden FileRequester, der komplett durch die
  94.        Library verwaltet wird
  95.        (unter OS V2.04+ wird stattdessen der FileRequester der
  96.     "asl.library" aufgerufen)
  97.      - einen leicht zu bedienenden ScreenMode-Requester, der komplett durch die
  98.        Library verwaltet wird
  99.        (unter OS V2.1+ wird stattdessen der ScreenModeRequester der
  100.     "asl.library" aufgerufen)
  101.      - einen Zufallszahlengenerator
  102.      - Funktionen zum Warten auf bestimmte Ereignisse (Linke Maustaste,
  103.        bestimmte Keyboard-Taste)
  104.      - etc.
  105.  
  106.     Schauen Sie in die Datei "AK_GEN0-Lib_Reference.doc", um eine volle Auf-
  107.     listung aller Funktionen zu erhalten !
  108.  
  109.     Hinweis : Die "ak_gen0.library" benutzt einige von Execs "Listen und Node"-
  110.           Funktionen. Falls Ihre OS-Version hier "Probleme macht",
  111.           probieren Sie's mal mit "SetPatch V1.xy".
  112.  
  113.  
  114.     Korrespondenz :
  115.     ===============
  116.  
  117.     Wenn Sie wollen, können Sie mir etwas Geld senden. Sicherlich
  118.     wird mich das motivieren, weiterhin solche Programme zu schreiben
  119.     oder einfach Updates zu diesem zu erstellen.
  120.     Senden Sie bug-reports, Geld oder was-auch-immer an :
  121.  
  122.        Andreas R. Kleinert,
  123.        Grube Hohe Grethe 23,
  124.        D-57074 Siegen,
  125.        Germany.              email : ...
  126.  
  127.  
  128.     Versions-Geschichte :
  129.     =====================
  130.  
  131.      V38.20 :
  132.      --------
  133.  
  134.       - Unterstützung des ASL-ScreenMode-Requesters (OS V2.1+/V38+)
  135.       - kleinere Fehler- und sonstige Verbesserungen
  136.       - Änderungen in den Includes
  137.       - Verwendung von SAS/C V6.3
  138.       - Programmierer-Hinweis : Erhöhen Sie Ihr spezifisches ak_gen0.library
  139.     Minimum auf V38. Versionen kleiner oder gleich V37 sollten nicht mehr
  140.     verwendet werden.
  141.  
  142.  
  143.      V38.1 :
  144.      -------
  145.  
  146.       - "code-splitting"
  147.       - "new look" für Prop-Gadgets unter Intuition V37+
  148.       - korrigierte Mode-Namen unter OS 1.3 :
  149.  
  150.     Lores [Interlace] -> LowRes [Interlace]
  151.     Hires [Interlace] -> HighRes [Interlace]
  152.  
  153.       - ModeRequester unterscheidet nun auch unter OS 1.3 zwischen
  154.     PAL und NTSC
  155.       - neues Default-Flag (AKBase) für den ModeRequester :
  156.     Verwendung der "echten" MaxOverScan-Werte (-1*MinX + MaxX, ...)
  157.     als Maximalwerte für Breite und Höhe.
  158.     Beispiel :
  159.            HighRes 724x283 anstelle
  160.                von 652x268
  161.  
  162.       - die Funktion "AK_ReadDir()" (OBSOLETE) verwendet jetzt intern
  163.     ebenfalls "AK_GetDirList()" bzw. "AK_FreeDirList()", wobei
  164.     der Wert -1 im Fehlerfall zurückgegeben wird.
  165.     Dies sollte kompatibel sein, da ohnehin nur Abfragen der Form
  166.  
  167.      for(i=0; i<=count; i++) printf("%s", direntry[i]);
  168.  
  169.     sinnvoll sind.
  170.  
  171.      - vier neue Funktionen zur Speicherverwaltung :
  172.  
  173.        - AK_GetMemList
  174.  
  175.      allokiert Liste für Speicher-Verwaltung
  176.  
  177.        - AK_FreeMemList
  178.  
  179.      delokiert Liste für Speicher-Verwaltung und eingetragenen Speicher
  180.  
  181.        - AK_AddMemEntry
  182.  
  183.      fügt einen Eintrag in die Liste ein
  184.      (falls nicht möglich, wird der Speicher freigegeben)
  185.  
  186.        - AK_AllocMemEntry
  187.  
  188.      belegt Speicher und fügt einen Eintrag in die Liste ein
  189.  
  190.  
  191.      V37.95 :
  192.      --------
  193.  
  194.       - Requester jetzt auch über Tastatur steuerbar :
  195.  
  196.     - interner FileRequester (nur für OS V1.3, also nicht ASL) :
  197.  
  198.        ESC      : Abbruch
  199.        P      : Parent
  200.        A      : Assigns
  201.        1..8   : Eintrag wählen
  202.        Return : Bestätigen
  203.  
  204.     - ModeRequester :
  205.  
  206.        ESC      : Abbruch
  207.        1..8   : Eintrag wählen
  208.        Return : Bestätigen
  209.  
  210.  
  211.      V37.89 :
  212.      --------
  213.  
  214.       - Requester-Typ wurde nicht gesetzt, daher keine Speicherfreigabe
  215.       - komplett neue Speicherverwaltung für die Requester
  216.     (neue, vorerst interne Routinen)
  217.       - Optimierungen bei den Requestern
  218.       - Propgadget-Strukturen jetzt 100% lokal
  219.       - Fehler im ModeRequester (undefinierte Einträge) korrigiert
  220.  
  221.  
  222.      V37.87 - V37.88 :
  223.      -----------------
  224.  
  225.       - AK_AutoRequester() modifiziert
  226.       - Propgadget-Strukturen jetzt local/static
  227.  
  228.  
  229.      V37.85 - V37.86 :
  230.      -----------------
  231.  
  232.      - kleinere Fehlerkorrekturen
  233.      - Verringerung der Code-Größe
  234.      - Berichtigung der Dokumentation
  235.  
  236.  
  237.      V37.83 :
  238.      --------
  239.  
  240.      - neue Hauptversion
  241.      - fünf neue Funktionen :
  242.  
  243.        - AK_GetDirList
  244.  
  245.      allokiert Liste für Directory-Inhalt und füllt diese
  246.  
  247.        - AK_FreeDirList
  248.  
  249.      delokiert Liste mit Directory-Inhalt
  250.  
  251.        - AK_GetModeList
  252.  
  253.      allokiert Liste für Screen-Modes und füllt diese
  254.  
  255.        - AK_FreeModeList
  256.  
  257.      delokiert Liste mit ScreenModes
  258.  
  259.        - AK_ModeRequest
  260.  
  261.      NEU : SCREEN-MODE-REQUESTER !!!
  262.  
  263.      - Umstellung auf SAS/C V6.00 :
  264.     - kürzerer Code
  265.     - Include-Files jetzt mit "tagcall" Pragmas
  266.       (Achtung : Möglichst die Pragmas verwenden !
  267.              Wenn IRGENDWELCHE Pragmas verwendet werden, aber
  268.              die "ak_gen0.library" mit den Stubs verwendet wird,
  269.              dann drohen Abstürze !!! )
  270.      - neues Include-File "ak_gen0_obsolete.h" mit alten Definitionen, etc.
  271.      - Fehlerkorrekturen (minimal zwar, aber dennoch !)
  272.      - u.a.
  273.  
  274.  
  275.     [ Die Versions-Geschichte der Versionen vor V37 ist nicht länger
  276.       enthalten. ]
  277.  
  278.  
  279.     Copyrights :
  280.     ============
  281.  
  282.     Einige der oben genannten Namen oder Produkte können Copyrights oder
  283.     Warenzeichen von Firmen sein.
  284.  
  285.  
  286.